home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / INTER29A.ARJ / INTPRINT.DOC < prev    next >
Text File  |  1991-09-01  |  7KB  |  154 lines
  1.                 INTPRINT v2.00
  2.                             by Ralf Brown
  3.  
  4. The INTPRINT program is hereby donated to the public domain, with the sincere
  5. hope that proper credit will be retained in all copies and derivatives.
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. INTPRINT.COM is a very simple formatter for the interrupt list.  Use
  10. this program to prevent widow lines at the beginning of a function call,
  11. number the pages, boldface key portions, center the printout, or create
  12. a summary of the function calls.  After formatting is complete, the
  13. total number of pages is displayed on the screen.
  14.  
  15. Usage:
  16.    intprint [options] intlist [[>|>>]outfile]
  17.  
  18. where the options are:
  19.     -Pname use control codes for the specified printer (-P? lists the
  20.           supported printers).  The printer name may be given in either
  21.           case and abbreviated to a unique prefix; use either dashes or
  22.           underscores in place of blanks in the printer name.
  23.     -tN   select typeface N for the chosen printer (currently supported
  24.           only for the HP).
  25.  
  26.     -m    specify that the interrupt list is in multiple parts beginning
  27.           with the named file.  INTPRINT will increment the last
  28.           character of the name to get the next filename, and continue
  29.           until it is unable to open the file thus selected.
  30.  
  31.     -lN   print N lines per pages, overriding the printer-specific
  32.           default.
  33.     -LN   assume N lines on a page.  If this is more than the number of
  34.           lines to print on each page, INTPRINT will use line feeds to
  35.           advance to the next page instead of form feeds.
  36.  
  37.         -b    boldface the title lines, Return:, and Notes: by overprinting
  38.         -B    boldface by sending printer control sequences
  39.  
  40.     -d    (duplex) print even/odd pages with different margins; suitable
  41.           for binding the printout.
  42.  
  43.         -p    print the page number at the bottom center of each page
  44.  
  45.         -iN   indent the output N spaces.  The output device is assumed to be
  46.               at least 80+N characters wide.
  47.           NOTE: you must put the number immediately after the 'i'; no
  48.               blanks are allowed.
  49.  
  50.         -e    assume printer is in elite mode (96 characters per line), and
  51.           indent the output eight spaces to center the printout.  This
  52.           is primarily for the default printer, as other printers may
  53.           force the equivalent or override this option.
  54.  
  55.     -I    assume the printer is capable of producing IBM character
  56.           graphics.  Printers other than "default" may force this option.
  57.  
  58.         -nN   assume N pages have already been printed, and start numbering
  59.               at N+1.  This option allows you to create a properly-numbered
  60.               printout even if there is not enough disk space to concatenate
  61.           the parts of the interrupt list or hold a complete output file.
  62.           See the examples below.
  63.           NOTE: you must put the number immediately after the 'n'; no
  64.               blanks are allowed.
  65.  
  66.     -rN:M print only pages N through M.  The entire input is processed
  67.           for use in -s and -f summaries (see below) even though only
  68.           a portion is formatted for printing.
  69.           NOTE: you must put the page numbers immediately after the 'r';
  70.           no blanks are allowed.
  71.  
  72.     -wN   (widow lines) search N lines from the end of the page for a
  73.           good place to break.  The default is ten lines; the valid
  74.           range is from 3 to one-half of the page length.
  75.           NOTE: you must put the number immediately after the 'w'; no
  76.               blanks are allowed.
  77.  
  78.         -sfile  create a one-line-per-function summary and write it to "file"
  79.               if -n is also given, the summary will be appended to "file",
  80.               allowing a properly numbered summary file to be created even if
  81.               there is not enough disk space to concatenate the parts of the
  82.               list.  See the examples below.
  83.           NOTE: you must put the filename immediately after the 's'; no
  84.               blanks are allowed.
  85.  
  86.         -ffile  create a file containing only the data structures described
  87.               in the interrupt list.
  88.           NOTE: you must put the filename immediately after the 'f'; no
  89.               blanks are allowed.
  90.  
  91. Options may not be combined; "-ep" is illegal and the "p" will be ignored.
  92.  
  93. The formatted result of the input file is sent to the specified output file,
  94. or to standard output if no output file is given.  Standard output may be
  95. redirected using the usual Unix or MSDOS redirection characters > or >>.  If
  96. you only want a summary file or data formats file, send or redirect the
  97. output to the null device ("NUL" under MSDOS, "/dev/null" under Unix).
  98.  
  99. ------------------------------------------------------------------------------
  100.  
  101. EXAMPLES:
  102. ---------
  103.  
  104.         Print the interrupt list with page numbers, and create a summary file,
  105.     without concatenating INTERRUP.A, INTERRUP.B, and INTERRUP.C:
  106.  
  107.         A> intprint -sb:interrup.sum -p interrup.a >prn
  108.         116 pages.   [screen output from INTPRINT]
  109.         A> intprint -sb:interrup.sum -p -n116 interrup.b prn
  110.         261 pages.   [screen output from INTPRINT]
  111.         A> intprint -sb:interrup.sum -p -n261 interrup.c >prn
  112.         386 pages.   [screen output from INTPRINT]
  113.  
  114.     or, more easily:
  115.         A> intprint -sb:interrup.sum -m -p interrup.a prn
  116.         658 pages.   [screen output from INTPRINT]
  117.  
  118.         Create only a summary file:
  119.  
  120.         C> intprint -sinterrupt.sum interrup.lst nul
  121.  
  122.         Print the interrupt list on an Epson FX80, using 54 lines per page and
  123.         omitting both page numbers and summary:
  124.  
  125.         C> intprint -Pepson -l54 interrup.lst >prn
  126.  
  127.     Print the interrupt list using 120 lines on every 132-line page (using
  128.     superscript mode, for example), and make divider lines using IBM
  129.     character graphics:
  130.  
  131.         C> intprint -I -l120 -L132 interrup.lst >prn
  132.  
  133.     Print only pages 123 through 127, assuming that 106 pages are contained
  134.     in the first section of the list:
  135.  
  136.         C> intprint -n106 -r123:127 interrup.b prn
  137.  
  138.     Print using HP PCL4/5 escape sequences, numbering pages, from file
  139.     "interrup.lst" to file "interrup.pcl", at the default 69 lines per
  140.     page, using form-feeds:
  141.  
  142.         C> intprint -Php -p interrup.lst >interrup.pcl
  143.         558 pages.   [screen output from INTPRINT]
  144.  
  145. ------------------------------------------------------------------------------
  146.  
  147. PORTABILITY:
  148. ------------
  149.  
  150. INTPRINT.C contains the source code for INTPRINT, for those people who are
  151. using the interrupt list on a machine which does not run MSDOS.  This code has
  152. been tested with Turbo C and Mach (BSD 4.3 Unix) "cc".
  153.  
  154.